home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / Performer_demo / pfconv.z / pfconv
Encoding:
Text File  |  2001-04-17  |  11.7 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ppppffffccccoooonnnnvvvv((((1111ppppffff))))          OOOOppppeeeennnnGGGGLLLL PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....4444 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss          ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppffffccccoooonnnnvvvv - OpenGL Performer file translator
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppffffccccoooonnnnvvvv [ options ] infile1 [ infile2 ... ] outfile
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      ppppffffccccoooonnnnvvvv is one of the sample programs distributed with the OpenGL
  16.      Performer high-performance graphics library.  ppppffffccccoooonnnnvvvv loads one or more
  17.      files into an OpenGL Performer scene graph, and then writes the resulting
  18.      scene graph out to a named output file.  It is installed in the /_u_s_r/_s_b_i_n
  19.      directory on IRIX, and /_u_s_r/_b_i_n/_X_1_1 on Linux.
  20.  
  21.      The following formats support file writing:
  22.  
  23.  
  24.           dwb       Coryphaeus Software Designer's Workbench format
  25.  
  26.           medit     Medit productions modeler format
  27.  
  28.           pfa       OpenGL Performer ASCII file format
  29.  
  30.           pfb       OpenGL Performer high-speed binary file format
  31.                     (recommended format)
  32.  
  33.      Here's an example that generates a fast-loading OpenGL Performer PFB
  34.      format file representing a Sierpinski sponge:
  35.  
  36.  
  37.           pfconv 2.sponge example.pfb
  38.           perfly example.pfb
  39.  
  40.  
  41.  
  42.      Preconverting files to the _p_f_b format can provide a great speed advantage
  43.      for demos and other applications where fast database loading is
  44.      important.
  45.  
  46.  
  47.  
  48.    ppppffffccccoooonnnnvvvv ccccoooommmmmmmmaaaannnndddd lllliiiinnnneeee ooooppppttttiiiioooonnnnssss
  49.           -b <mode>,<value>             -Set builder mode (default value is OFF)
  50.           -B <mode>,<value>             -Set builder mode (default value is ON)
  51.                               See the ppppffffddddBBBBllllddddrrrrMMMMooooddddeeee reference page
  52.                               for more information.
  53.               0 -> PFDBLDR_MESH_ENABLE
  54.               1 -> PFDBLDR_MESH_SHOW_TSTRIPS
  55.               2 -> PFDBLDR_MESH_INDEXED
  56.               3 -> PFDBLDR_MESH_MAX_TRIS
  57.               4 -> PFDBLDR_MESH_RETESSELLATE
  58.               5 -> PFDBLDR_MESH_LOCAL_LIGHTING
  59.              10 -> PFDBLDR_AUTO_COLORS
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppffffccccoooonnnnvvvv((((1111ppppffff))))          OOOOppppeeeennnnGGGGLLLL PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....4444 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss          ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  71.  
  72.  
  73.  
  74.                    0 -> PFDBLDR_COLORS_PRESERVE  + leave colors alone
  75.                    1 -> PFDBLDR_COLORS_MISSING   - make missing colors
  76.                    2 -> PFDBLDR_COLORS_GENERATE  - make all colors
  77.                    3 -> PFDBLDR_COLORS_DISCARD   - toss existing colors
  78.              11 -> PFDBLDR_AUTO_NORMALS
  79.                    0 -> PFDBLDR_NORMALS_PRESERVE - leave normals alone
  80.                    1 -> PFDBLDR_NORMALS_MISSING  + make missing normals
  81.                    2 -> PFDBLDR_NORMALS_GENERATE - make all normals
  82.                    3 -> PFDBLDR_NORMALS_DISCARD  - toss existing normals
  83.              12 -> PFDBLDR_AUTO_TEXTURE
  84.                    0 -> PFDBLDR_TEXTURE_PRESERVE + leave texture coord alone
  85.                    1 -> PFDBLDR_TEXTURE_MISSING  - make missing texture coord
  86.                    2 -> PFDBLDR_TEXTURE_GENERATE - make all texture coord
  87.                    3 -> PFDBLDR_TEXTURE_DISCARD  - toss existing texture coord
  88.              13 -> PFDBLDR_AUTO_ORIENT
  89.                    0 -> PFDBLDR_ORIENT_PRESERVE  - leave normal and order alone
  90.                    1 -> PFDBLDR_ORIENT_NORMALS   - make normal match vertex order
  91.                    2 -> PFDBLDR_ORIENT_VERTICES  + make vertex order match normal
  92.              15 -> PFDBLDR_AUTO_DISABLE_TCOORDS_BY_STATE
  93.                    0 - dont remove tcoords if no texture specified
  94.                    1 - remove tcoords if no texture specified
  95.              16 -> PFDBLDR_AUTO_DISABLE_NCOORDS_BY_STATE
  96.                    0 - dont remove ncoords if no material specified
  97.                    1 - remove ncoords if no material specified
  98.              17 -> PFDBLDR_AUTO_LIGHTING_STATE_BY_NCOORDS
  99.                    0 - dont automatically set lighting enable based on presence of ncoords
  100.                    1 - automatically set lighting enable based on presence of ncoords
  101.              18 -> PFDBLDR_AUTO_LIGHTING_STATE_BY_MATERIALS
  102.                    0 - dont automatically set lighting enable based on presence of material
  103.                    1 - automatically set lighting enable based on presence of material
  104.              19 -> PFDBLDR_AUTO_TEXTURE_STATE_BY_TEXTURES
  105.                    0 - dont automatically set texture enable based on presence of tcoords
  106.                    1 - automatically set texture enable based on presence of tcoords
  107.              20 -> PFDBLDR_AUTO_TEXTURE_STATE_BY_TCOORDS
  108.                    0 - dont automatically set texture enable based on presence of texture
  109.                    1 - automatically set texture enable based on presence of texture
  110.              30 -> PFDBLDR_BREAKUP
  111.              31 -> PFDBLDR_BREAKUP_SIZE
  112.              32 -> PFDBLDR_BREAKUP_BRANCH
  113.              33 -> PFDBLDR_BREAKUP_STRIP_LENGTH
  114.              34 -> PFDBLDR_SHARE_MASK
  115.              35 -> PFDBLDR_ATTACH_NODE_NAMES
  116.              36 -> PFDBLDR_DESTROY_DATA_UPON_BUILD
  117.              37 -> PFDBLDR_PF12_STATE_COMPATIBLE
  118.              38 -> PFDBLDR_BUILD_LIMIT  -maximum number of tris/strip
  119.           -F <path>                     -Set file path
  120.           -n <notify>                   -Debug level
  121.           -o <mode>,<value>             -Set optimizer mode (default value is OFF)
  122.           -O <mode>,<value>             -Set optimizer mode (default value is ON)
  123.               0 -> pfdMakeShare                      defaults to ON
  124.               1 -> pfdCombineLayers                  defaults to ON
  125.               2 -> pfFlatten                         defaults to ON
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppffffccccoooonnnnvvvv((((1111ppppffff))))          OOOOppppeeeennnnGGGGLLLL PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....4444 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss          ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  137.  
  138.  
  139.  
  140.               3 -> pfdCleanTree                      defaults to ON
  141.               4 -> pfdCombineBillboards,<size_limit> defaults to OFF
  142.               5 -> pfdFreezeTransforms               defaults to OFF
  143.               6 -> pfPartition                       defaults to OFF
  144.  
  145.  
  146.  
  147.      Examine the source code to ppppffffccccoooonnnnvvvv to understand the optimization
  148.      transformations that can be applied to files as they are loaded.  By
  149.      default, only safe optimizations are performed, but there are several
  150.      other optimizations, some quite aggressive, that can be enabled
  151.  
  152.  
  153.  
  154.    SSSSuuuuppppppppoooorrrrtttteeeedddd DDDDaaaattttaaaabbbbaaaasssseeee FFFFoooorrrrmmmmaaaattttssss
  155.      ppppffffccccoooonnnnvvvv, like all OpenGL Performer applications, is able to directly load
  156.      3D data in a large selection of popular formats and draw that data at
  157.      high speed.  All of the following file formats are understood by pfconv:
  158.  
  159.  
  160.           3ds       AutoDesk _3_D_S_t_u_d_i_o binary data
  161.           bin       Minor SGI format used by _p_o_w_e_r_f_l_i_p
  162.           bpoly     Side Effects Software _P_R_I_S_M_S binary
  163.           byu       Brigham Young University CAD/FEA data
  164.           dwb       Coryphaeus Software _D_e_s_i_g_n_e_r'_s _W_o_r_k_b_e_n_c_h
  165.           dxf       AutoDesk _A_u_t_o_C_A_D ASCII format
  166.           flt11     MultiGen public domain Flight v11 format
  167.           flt14     MultiGen _O_p_e_n_F_l_i_g_h_t v14 format
  168.           gds       McDonnell-Douglas GDS _t_h_i_n_g_s data
  169.           gfo       Minor SGI format (radiosity output)
  170.           im        Minor SGI format (OpenGL Performer example)
  171.           irtp      AAI/Graphicon _I_n_t_e_r_a_c_t_i_v_e _R_e_a_l-_T_i_m_e _P_H_I_G_S
  172.           iv        SGI OpenInventor / Silicon Studio Keystone
  173.           lsa       Lightscape Technologies radiosity (ASCII)
  174.           lsb       Lightscape Technologies radiosity (binary)
  175.           m         University of Washington mesh data
  176.           medit     Medit Productions _m_e_d_i_t modeling tool
  177.           nff       Eric Haines' ray tracing test data format
  178.           obj       Wavefront Technologies data format
  179.           phd       Minor SGI format (polyhedra)
  180.           pfa       OpenGL Performer ASCII database format
  181.           pfb       OpenGL Performer BINARY database format
  182.           poly      Side Effects Software _P_R_I_S_M_S ASCII data
  183.           pts       University of Washington point data
  184.           ptu       Minor SGI format (OpenGL Performer example)
  185.           sgf       US NAVY standard graphics format
  186.           sgo       Minor SGI format
  187.           spf       US NAVY simple polygon format
  188.           sponge    Sierpinski sponge 3D fractal generator
  189.           star      Yale University compact star chart data
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ppppffffccccoooonnnnvvvv((((1111ppppffff))))          OOOOppppeeeennnnGGGGLLLL PPPPeeeerrrrffffoooorrrrmmmmeeeerrrr 2222....4444 RRRReeeeffffeeeerrrreeeennnncccceeee PPPPaaaaggggeeeessss          ppppffffccccoooonnnnvvvv((((1111ppppffff))))
  203.  
  204.  
  205.  
  206.           stla      3D Structures Stereolithography (ASCII)
  207.           stlb      3D Structures Stereolithography (binary)
  208.           sv        Format of John Kichury's _i_3_d_m modeler
  209.           tri       University of Minnesota Geometry Center data
  210.           unc       University of North Carolina data
  211.  
  212.  
  213.  
  214.    LLLLeeeeaaaarrrrnnnniiiinnnngggg MMMMoooorrrreeee
  215.      Once you've seen OpenGL Performer in action, you will want to learn more
  216.      about it.  The OpenGL Performer Programming Guide and the OpenGL
  217.      Performer Release Notes are the primary sources of information, but the a
  218.      number of information sources are available to give you a good start in
  219.      your learning process. The origin of this quest is the Performer man
  220.      page. Just type "man performer" and just about everything you might want
  221.      to know will be there or in one of the on-line resources listed there.
  222.  
  223.  
  224. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  225.      ppppeeeerrrrffffoooorrrrmmmmeeeerrrr, ppppffffccccoooonnnnvvvv
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.